SFTM (SpatialFOFEM Tree Mortality)

SpatialFOFEM Mortality is a first order fire effects model for predicting tree mortality caused by prescribed fire or wildfire. 

• For more information about the model see the Desktop Application User Guide.

• First Order Fire Effects calculations produced with the command line applications developed by the Missoula Fire Sciences Laboratory, Missoula, MT.

The SpatialFOFEM Tree Mortality model requires two inputs to run:

• A GeoTIFF

• An input file

 

GeoTIFF

The SpatialFOFEM Tree Mortality model requires a GeoTIFF.  The GeoTIFF is generated in the FMSF, prior to making a run request (see Create a TreeMap GeoTIFF), and the ID is used when making the model run request (see Run a Model).

The GeoTIFF must have one band that identifies the Tree List ID and can contain a band defining the Flame Length and can contain additional bands.

Band Name	Units	Required
Tree List ID	categorical	Required
Flame Length *	feet	Optional

*Due to the current limitation of creating the GeoTIFF for this model from within the FMSF a flame length band cannot be used.

 

Input file

The various input and output switches included in the input file (*.txt or *.input) passed to the FMSF are documented in the following sections with the valid ranges for each switch.

Example SpatialFOFEM Tree Mortality input file including all the input and output switches.

 

TreeMap Switch

FOFEM_TreeListID_Layer_Number: 1

 

FOFEM_TreeListID_Layer_Number: X where X is an integer representing the band number in the GeoTIFF of the TreeMap data.

• Valid range: 1-1000

 

Flame Length Switches

FOFEM_Flame_Length: 4.5

FOFEM_Flame_Length_Precision: 2

 

​FOFEM_Flame_Length​: X where X is the global flame length (in feet) to be applied in mortality calculations. This value is used when a flame length layer is not supplied or in areas of <NoData> within the flame length layer.

• Valid range: 0-20

FOFEM_Flame_Length_Precision​: X where X is an integer indicating the degree of decimal precision for flame length values used in calculating mortality.

• Valid range: 0-9

 

Tree Mortality Switches

FOFEM_Mortality_Species: 4

ABCO

ABMA

PIJE

PIPO

FOFEM_Mortality_SPP_Assign: 2

PIJE POTR5

PIPO PICO

FOFEM_Mortality_Size_Classes: 3

1

6

12

 

FOFEM_Mortality_Species​: X where X is an integer representing the number of subsequent tree species codes to be analyzed, followed by X lines containing NRCS species codes to run tree mortality on.

• NOTE: Species listed here generate output GeoTIFFs.

• NOTE: Natural Resources Conservation Service (NRCS) species codes must be used and be capitalized. Not all codes are available, see FOF_SPP.csv for a complete list.

Mortality species data entries must be:

• Species code

  • Valid range: NRCS codes in FOFEM

FOFEM_Mortality_SPP_Assign: X where X is an integer representing the number of species equation set assignments, followed by X lines of species code pairs (space delimited).

• NOTE: This is an optional input

• NOTE: This is used to allow mortality predictions for species that do not have mortality equations assigned or to assign different mortality equations

• NOTE: NRCS species codes must be used and be capitalized. Not all codes are available, see FOF_SPP.csv for a complete list of available species and the mortality equations assigned.

Mortality species assign data entries must be:

• Original species code

  • NOTE: Species codes must be capitalized

  • Valid range: NRCS codes in FOFEM

• Replacement species code

  • NOTE: Species codes must be capitalized

  • Valid range: NRCS codes in FOFEM

​FOFEM_Mortality_Size_Classes​: X where X is an integer indicating the desired number of size breaks to use, followed by X lines defining the lower limits of the DBH size class breakpoints (inches). 

• Valid range: >0

Mortality size class data entries must be in ascending order.:

• DBH break point (inches)

  • NOTE: When the class limits include decimal digits, the class will be rounded to the nearest 0.1 inch

  • Valid range: >=0

 

Output Switches

All outputs are provided - there are no output switches for SpatialFOFEM Tree Mortality. The outputs are described below.

 

Grid outputs (individual GeoTIFFs)

Individual GeoTIFFs are produced for the gridded outputs.  The number of GeoTIFFs created depends on the FOFEM_Mortality_Species and FOFEM_Mortality_Size_Classes inputs.  The GeoTIFF naming convention is: <RunID_Mortality.tiff>_<species code>_<lower DBH limit-upper DBH limit>_<output type>.TIF

Output	Units	Description
PreFireTotal	Count	Number of trees in the cell before fire
PostFireTotal	Count	Number of trees in the cell after fire
KilledTotal	Count	Number of trees killed by fire in the cell
PreFireTPA	Trees per acre	Trees per acre before fire
PostFireTPA	Trees per acre	Trees per acre after fire
KilledTPA	Trees per acre	Trees killed by fire
Mortality	Probability	Mortality probability

 

Non-grid outputs

MortalityWarnings.csv reports any tree species codes included in TreeMap GeoTIFF that are not defined in the FOF_SPP.csv and not assigned a recognized code with the FOFEM_Mortality_SPP_Assign switch.

MortalitySummary.csv summarizes these outputs across all cells with values (not null) included in the TreeMap GeoTIFF (all averages are arithmetic).

 

Switches Not Currently Supported by the FMSF

The FMSF does not currently support all switches available within the SpatialFOFEM model. Those not supported are listed below.

FOFEM_Flame_Length_File: X where X is the complete path to the GeoTIFF file containing flame length values.

• Currently the FMSF only allows GeoTIFFs created via the FMSF or LANDFIRE.

​FOFEM_Flame_Length_Layer_Number​: X where X is an integer representing the band number in the GeoTIFF containing the flame length data (feet).

• Currently the FMSF only allows GeoTIFFs created via the FMSF or LANDFIRE.